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1.0  Scope 

Per  DI-MISC-8071 1,  this  manual  details  the  Management  Command  &  Control  (MCC)  Cold 
Start  Procedures.  Distribution  instructions,  interaction  with  other  simulators,  and  hardware 
compatibility  notes  (as  applicable),  build  instructions  as  well  as  a  detailed  overview  of  the 
software  release  are  included  in  the  ADST  Version  Description  Document  for  the  BDS-D 
MCC  /  Masscomp  Host  1.0.0;  document  number  ADSTAVDL/TR-93-003042. 


"I  Pete  Peterson  on  this  date  5/21/93,  hereby  certify  that  the  software  release  BDS-D  MCC/ 
Masscomp  Host  1.0.0  has  been  built  from  limited  access,  controlled  baseline.  This  software 
is,  to  the  best  of  my  knowledge,  free  of  malicious  code  intended  to  subvert  its  operation." 
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2.0  Cold  Start  Methodology 

The  Cold  Start  procedure  for  the  MCC  describes  the  user’s  ability  to  regenerate  a 
Masscomp  5600  operating  system  and  load  the  MCC  application  software.  This  procedure 
consists  of  installing  and  bringing  on-line  the  operating  system,  application,  source  files, 
data  files,  boot  files,  configuration  files  and  databases.  Verification  of  a  build  load  is 
demonstrated  through  a  series  of  checklists.  This  procedure  also  provides  a  detailed  list  of 
instructions  that  allow  the  user  to  startup  and  shutdown  the  MCC. 

2.1  Required  Resources 

The  following  sections  outline  the  required  hardware  and  software  resources  needed  to 
install  and  bring  on-line  the  Masscomp  based  MCC. 

2.1.1  Hardware  Resources 

The  Masscomp  based  MCC  requires  the  following  hardware  configuration  resources  to 
run: 

Hardware  Item  Inscription 

Masscomp  5600  Masscomp  5600  computer  running  RTU  4.0A  operating  system. 

150  MB  tape  drive  A  150  MegaByte  tape  drive  must  be  installed  in  the  Masscomp  5600 
computer  for  application,  source,  and  operating  system  installations. 


2. 1 .2  Software  Resources 


The  magnetic  media  (disks  and  tapes)  prepared  and  supplied  as  pan  of  the  BDS-D  MCC 
1.0.0  are  identified  below: 


MediaJype 

Label 

DC  6 150  Tape 

BDS-D 

DC  6 150  Tape 

BDS-D 

MCC  /  Masscomp  Host  1.0.0 
MCC  /  Masscomp  Host  1.0.0 


5  1/4"  Floppy  disk  Boot  Disks 
DC  6150  Tape  RTU4.0A  system  tape 


Percriptjpn 

MCC  /  Masscomp  Host 
1 .0.0  application  tape 

MCC  /  Masscomp  Host 
1 .0.0  source  tape 

Stand  alone  boot  disks  (#1 
&  #2) 

RTU4.0A  system  dump 
tape 


2.1.3  Other  Required  Resources 
There  are  no  other  required  resources. 

2.2  Cold  Start  Procedures 
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The  following  section  outlines  the  procedure  for  performing  a  cold-start  on  the  Masscomp 
5600  system. 

2.2.1  System  Preparation 

This  section  describes  formatting  the  disks  on  the  Masscomp  5600  and  installing  the  RTU 
4.0A  operating  system.  These  instructions  demonstrate  how  to  format  the  system  disk, 
install  the  operating  system,  and  perform  system  checks  verifying  that  the  operating  system 
is  running  correctly.  (Warning!!!  -  This  section  should  only  be  performed  by  trained 
system  personnel,  due  to  hardware  differences  between  systems.) 


SYSTEM  PREPARATION 


1  — y :Tii m.xtw n n  i  iiiimii 

EXPECTED  RESULTS 

1 .  Log  in  to  the  Masscomp  as  root 

The  console  terminal  will  display  the  system 
prompt,  (i.e  S1MLAB13#) 

2.  Reboot  the  computer  to  single-user  mode: 

Enter:  reboot  -h  (or)  sync;sync;halt 

The  console  terminal  will  display  the  single-user 
prompt:  »> 

3.  Insert  stand-alone  floppy  #1  into  floppy  drive. 

None 

4.  Enter:  b/f:l  flp 

The  Masscomp  will  read  from  the  floppy  and,  when 
finished,  the  console  terminal  will  display  the  $$ 
prompt. 

5.  Insert  stand-alone  floppy  #2  into  floppy  drive. 

None 

6.  To  format  the  internal  hard  disk  drive,  enter: 
/stand/xmeformat  /dev/caO 

The  console  terminal  will  display:  Warning!!!  This 
program  is  about  to  wipe  out  all  contents  of  your 
disk.  Are  you  sure  (ok)? 

7.  Enter:  ok 

The  console  terminal  will  display: 

Choose  one  of  the  following: 

(0)  Custom  Geometry  -  manual  entry 

(1)  Micropolis  85  mb  (Has  a  rectangular  LED  ...) 

(2)  Fujitsu  85  mb  (Has  a  round  LED  on  the  disk...) 

(3)  Micropolis  170  mb  ESDI 

(4)  Micropolis  382  mb  ESDI 

Which  menu  selection  (0-4)?: 

8.  Enter:  3 

The  console  terminal  will  display: 

Format  the  drive  (yes  or  no)? 

9.  Enter  :  yes 

The  console  terminal  will  display: 

Do  you  want  to  enter  the  media  defect  list  (yes  or 
no)? 

10.  Enter:  yes 

The  console  terminal  will  wait  for  your  entry. 

1 1 .  Install  the  media  defect  floppy  into  the  floppy 
disk  drive,  and  enter  the  name  of  the  defect  list  file 
which  appears  on  the  floppy  label: 
example:  707809.list 

The  console  terminal  will  display  the  following: 
Geometry  block  present  on  disk 

Use  existing  bad  block  list  (yes  or  no)? 

The  console  terminal  will  display  the  following: 

Geometry  block  present  on  disk 

Use  existing  bad  block  list  (yes  or  no)? 
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12.  Enter:  no 

The  message  "formatting..."  will  appear  and  the  disk 
drive  LED  will  light  up.  Note:  During  the  format 
operation,  several  format  related  messages  will 
appear.  Error  messages  are  self-explanatory.  The 
final  message  to  appear  should  be:  "wrote  had  sector 
list  for  drive  serial  #  707809"  and  the  $S  prompt 
will  appe;tr. 

13.  Insert  stand-alone  floppy  #  1  into  floppy  drive. 

None 

14.  Create  an  empty  file  system;  enter; 

/stand/mkfs  /dev/caO 

An  empty  file  system  /dev/caO  is  created,  the  sizes 
are  displayed. 

15.  Check  the  file  system  integrity; 
enter:/stand/fsck  /dev/caO 

Phases  0  to  5  of  the  file  system  check  are  displayed. 

16.  Insert  stand-alone  floppy  #2  into  floppy  drive 
and  enter:  /stand/writehoot  /dev/caO 

A  boot  block  will  be  written  to  the  hard  drive. 

17.  At  the  $S  prompt,  insert  the  tape  marked 
"RTU4.0A  system  tape"  into  the  cartridge  tape 
drive  and  enter:  /stand/restor 

The  prompt:  tape?  will  appear  on  the  console 
terminal 

18.  Enter  /dev/ctp 

The  prompt:  disk?  will  appear  on  the  console 
terminal 

19.  Enter:  /dev/caO 

The  prompt:  Last  chance  before  scribbling  on  disk. 

20.  Enter  N/L  (note:  upper  case) 

The  tape  will  start  to  move,  files  will  be  restored  to 
die  disk.  When  the  restore  is  complete,  a  $$  prompt 
will  appear  on  the  console  terminal. 

21.  Enter:  /stand/fsck  /dev/caO 

The  file  system  will  be  checked  (phases  0  -  5) 

22.  Enter:  console 

The  console  prompt  »>  will  appear  on  the  console 
terminal. 

23.  Enter:  h  caO/unix 

The  system  will  boot  up  into  inulli-user  mode,  the 
prompt  "To  use  current  time,  enter  RETURN"  will 
appear. 

24.  Enter  the  current  date  and  time  in  the  following 
format:  07-Apr-93  16:00 

The  console  terminal  will  display  messages,  the 
prompt  system  prompt  (i.e  S1MLAB13  #)  will 
appear,  then  the  multi-user  login  prompt  (login:) 
will  appear. 

25.  Enter:  root 

The  prompt  TERM  =  (vtlOO)  will  appear. 

26.  Enter  a  carriage  return 

The  screen  will  clear,  dale  and  time  will  appear,  then 
the  system  prompt  (i.e.  SIMLAB13  #). 

27.  Remove  floppy  and  tape  and  proceed  to 
installation  of  release. 

None 
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2.2.2  Installation  of  Release 

This  section  describes  the  installation  of  the  BDS-D  MCC  /  Masscomp  Host  1.0.0  release 
tape  on  to  the  Masscomp  5600  computer  system.  A  list  of  executable  files,  data  files, 
configuration  files,  startup  and  shutdown  files  and  their  respective  location  in  the  directory 
tree  is  shown  in  Table  2-1.  Table  2-1  allows  the  user  to  verify  that  what  was  copied  off  the 
BDS-D  MCC  /  Masscomp  Host  1.0.0  release  tape  on  to  the  target  machine  to  run  in  an 
operational  environment  is  a  complete  list  of  application  files  and  their  location  in  the 
directory  tree. 


INSTALLATION 


iMEBIIMumiuaikiiaii  inmlM  llili  T  il1!  MU 

None 

2.  Log  on  to  the  Masscomp  5600  as  root. 

The  console  terminal  will  display  the  system 
prompt:  (i.e.  SIMLAB13  #) 

3.  Set  to  the  correct  default  directory 

cd  /directorv_name 

The  console  terminal  will  display  the  system 
prompt:  (i.e.  SIMLAB13  #) 

4.  Read  in  the  installation  tape.  Enter: 
tar  xvf  /dev/rctp 

The  tape  will  move,  filenames  will  scroll  by  on  the 
console  terminal. 

5.  When  the  tape  is  fully  rewound  and  die 
SIMLAB13  #  prompt  appears,  remove  the 
installation  tape. 

None 

Table  2-1 

/MCC_  1.0.0 

bin/MCC 

bin/MCC-Mother 


bin/MCC-ATSend 
bin/MCC- ATRecv 
bin/MCC-SCC 

bin/MCC-Place 

bin/MCC-FSE 

bin/MCC-CAS 


Description 


Shell  script  that  starts  the  MCC 
application 

Executable  that  provides  a  wide 
variety  of  functions.  Initializes  MCC 
host  software,  does  computer 
simulation  of  vehicles,  records 
statistics  collected  from  exercise, 
sends  and  receives  packets  from  the 
SIMNET  network. 

Formats  messages  going  from  the 
host  to  the  AppleTalk  network. 
Unformats  messages  coming  to  the 
host  to  the  AppleTalk  network. 
Process  in  communication  with  SCC 
console.  Keeps  track  of  activation 
state  of  manned  vehicles,  placement 
of  gunnery  targets,  command  posts... 
Process  in  communication  with  Place 
console.  Forwards  activation 
information  to  SCC  process. 

Process  in  communication  with  FSE 
console.  Keeps  state  table  of 
howitzers  and  mortars. 

Process  in  communication  with  CAS 
console.  Keeps  state  of  bombing 
runs. 
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bin/MCC-CEC 

bin/MCC-Maint 

bin/MCC-Admin 

simnet/terrain/data/knox-03 1 1 

*  simnet/data/network.def 

*  simnet/data/assoc.def 

*  simnet/data/MCC-params 

*  simnet/data/MCC-pars.alt 

*  simnet/data/simnet.mac 

*  These  files  are  site/host  specific  and  are  not 


Process  in  communication  with  CEC 
console.  Keeps  state  of  combat 
engineer  missions. 

Process  in  communication  with  Maint 
console.  Keeps  state  of  recoveries 
and  repairs. 

Process  in  communication  with 
Admin  log  console.  Keeps  state  of 
combat  service  support  vehicles. 
Terrain  database  provides  information 
about  the  simulated  terrain. 

Defines  the  configuration  of  the  CMC 
Ethernet  card  and  host  interface. 
Defines  the  unique  site  and  host  ID  of 
the  MCC  host  computer. 

Provides  information  about  which 
consoles  are  active,  at  which  serial 
port  to  find  the  MCC  bridge,  which 
exercise  ID  to  use.  etc. 

Provides  alternate  parameter 
information  such  as  ammo  mappings, 
vehicles  mappings,  and  parameters 
used  to  define  minefields. 

Defines  macro  mappings  of  names 
and  their  hexidecimal  equivalents. 

included  in  the  release  tape. 
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2.3  Warm  Start  and  Shutdown  Procedures 

The  following  section  outlines  the  procedure  for  performing  a  warm-start  and  shutdown  of 
the  Masscomp  5600  system. 


2.3.1  Startup  Procedures 

This  section  describes  in  detail  how  to  startup  the  MCC. 

STARTUP  PROCEDURES 


CONTROL  ACTION 

EXPECTED  RESULTS 

1 .  Locate  the  MCC  and  the  Masscomp  5600 
computer  that  the  installation  will  be  performed  on. 

None 

2.  Power  up  the  Masscomp  5600  by  turning  the 
keyswitch  (located  on  the  front  panel)  to  the  "  1 " 
position. 

The  console  terminal  will  display:  login: 

3.  Log  in  as  root 

The  console  terminal  will  display  a  system 
prompt.(i.e.  SIMLAB13  #) 

4.  Change  to  the  binary  executable  directory. 

Enter:  cd  /simnet/hin 

The  console  terminal  will  display  a  system 
prompt. (i.e.  S1MLAB13  #) 

5.  Start  up  the  network  and  CICi  communications: 
Enter:  netstart 

The  console  terminal  will  display: 

Killing  running  ringstart... 

Resetting  /dev/enpO... 

Loading  /simnet/bin/enp.bin  on  /dev/enpO... 
Starting  /simnet/bin/ringstart... 

[1]  82 

Done 

SIMLAB13  # 

6.  Start  up  the  MCC. 

Enter:  MCC 

The  MCC  will  respond  with  various  status 
messages  to  keep  the  operator  informed  of 
the  MCC  startup  status. 
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2.3.2  Shutdown  Procedure 

The  following  written  set  of  procedures  describe  in  detail  how  to  shutdown  the  MCC. 

SHUTDOWN  PROCEDURES 


Control  aCtiOn 

EXPECTED  RESULTS 

1.  On  console  terminal,  quit  the  simulation  if 
running.  Enter:  q 

Simulation  should  exit.  Console  terminal  will 
display  system  prompt  (i.e.:  SIMLAB13  #) 

2.  At  the  SIMLAB13  #  prompt,  entershutdown 
(or) 

At  the  SIMLAB13  #  prompt,  enter:  sync 

sync 

halt 

The  message:  syncing  disks...  will  appear,  then  the 
prompt  »>  will  be  displayed. 

3.  Turn  the  front  panel  key  switch  to  the  "0" 
position. 

The  system  will  power  off. 
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3.0  Release  Validations 

3.1  Cold  Start  Validation 

The  following  written  set  of  procedures  instructs  the  user  on  how  to  validate  the  success  of 
the  cold-start 

Cold-start  Validation  Instructions: 

The  expected  results  detailed  in  the  System  Preparation  and  Release  Installation  Procedure 
sections  are  indicative  of  a  successful  cold-start. 

3.2  Warm  Start  Validation 

The  following  written  set  of  procedures  instructs  the  user  on  how  to  validate  the  load  once  it  is 
operational. 

Warm  Start  Validation  Instructions: 

The  expected  results  detailed  in  the  Startup  Procedure  section  are  indicative  of  a  successful  warm 
start.  After  completion  of  Startup  Procedure  step  6,  the  MCC  may  be  activated. 
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